await

您所在的位置:网站首页 try catch用法js await

await

#await| 来源: 网络整理| 查看: 265

前言

await-to-js 的源码较少,代码较少的情况,可以尝试采用 3W 方法进行源码分析,帮助快速了解它的实际应用场景。

阅读本文,会有以下收获:

了解 await-to-js 库能解决什么问题。 分析 await-to-js 库是如何解决问题。 摸索 await-to-js 库的实际使用场景。 Why:await-to-js 诞生的契机

打开它的 github 地址,有很简单的一句介绍:

Async await wrapper for easy error handling

这句话的意思是:

Async await 包装器,便于错误处理

等等,async 和 await 怎么捕获异常来着。

常规异常捕获

一般情况下,await 命令后面是一个 Promise 对象,返回该对象的结果。

如果我们希望捕获 Promise 中的错误, 这个时候需要将 await 放在try...catch结构里面。

同时,这样做,无论前面的 await 是否成功,都不会影响后续的功能。

功能设计

该功能设计源自源码的 examples 文件中提供的案例,我将它改成了使用 await-to-js 前的写法。

UserModel:提供了 findById 方法,是一个 Promise,它主要做了两件事,如果 userId 存在,则返回 userObjet 对象,如果 userId 不存在,则用 reject 抛出错误。 asyncTask: 两个参数,userId 和结果返回函数。使用async / await 处理异步操作 UserModel,将 await 放在 try...catch 结构里面。如果 UserModel 正常,则判断是否查到了 userId,如果 UserModel 阻塞,也不影响后面代码的执行。 调用 asyncTask 的时候,第一个参数传 null 。 const UserModel = { findById: userId => { return new Promise((resolve, reject) => { if (userId) { const userObjet = { id: userId, notificationsEnabled: true, }; return resolve(userObjet); } reject('Data is missing'); }); }, }; /** * 异步任务 */ async function asyncTask(userId, cb) { try { const user = await UserModel.findById(userId); if (!(user && user.id)) return cb('No user found'); } catch () {; } return cb('前面的 await 可能失败了'); } asyncTask(null, (err, newTask) => { console.log('fail'); console.log(err); console.log(newTask); }); 复制代码

运行结果

因为 userId 的值为 null,所以 UserModel.findById 抛出了异常,而我在 catch 中没有做任何处理,所以后面的代码正常运行,将最后的代码处理结果抛给了 cb 函数。

所以,最终打印 cb 里的结果:

捕获异常

如果需要进行异常的捕获,在 catch 中将错误返回即可。

async function asyncTask(userId, cb) { try { const user = await UserModel.findById(userId); if (!(user && user.id)) return cb('No user found'); } catch (e) { return cb(e); } return cb('前面的 await 可能失败了'); } 复制代码

运行结果

此时返回的报错内容为: Data is missing

契机

上面的例子中,虽然代码运行正常,也可以进行异常的捕获。

但是有个问题,如果想捕获不同场景下的异常,需要将每个场景都放到 try...catch 结构中,这样代码会显得有些冗余。

能否,将 try...catch 结构封装起来,直接返回结果?

这不,await-to-js 就诞生了么。

What:如何优雅捕获异常

开头说源码内容少,并不是说说看,它是真的少。

核心源码

源码用的 TypeScript,因为代码量不多,所以没有用过 TypeScript 的开发者,也可以很顺畅的阅读。

/** * @param { Promise } promise * @param { Object } errorExt - Additional Information you can pass to the err object * @return { Promise } */ export function to ( promise: Promise, errorExt?: object ): Promise { return promise .then((data: T) => [null, data]) .catch((err: U) => { if (errorExt) { const parsedError = Object.assign({}, err, errorExt); return [parsedError, undefined]; } return [err, undefined]; }); } export default to; 复制代码

不过,想看用 JavaScript 写的也不难,将项目 build 一下,就能得到。顺便在上面加了些注释:

/** * @param { Promise } promise * @param { Object } errorExt - Additional Information you can pass to the err object * @return { Promise } */ function to(promise, errorExt) { return promise .then(function (data) { // 返回数组值:第一个元素是错误信息(只有报错时有值),第二个元素是数据信息(只有成功时有值) return [null, data]; }).catch(function (err) { // =>true: 如果添加了额外的错误描述,则和错误描述合到一个空对象上 if (errorExt) { var parsedError = Object.assign({}, err, errorExt); return [parsedError, undefined]; } return [err, undefined]; }); } export { to }; export default to; 复制代码

这里需要注意下面几点:

errorExt 是 Object 类型。 Object.assign 在进行拷贝的时候,会把非 Object 类型转成 Object 类型。 const err1 = 'time'; const err2 = 's'; const task = Object.assign({}, err1, err2); console.log(task); // { '0': 's', '1': 'i', '2': 'm', '3': 'e' } 复制代码 疑问

关于 errorExt 我是有疑问的,它的结果到底怎么回显?

源码中,promise 中的 reject 抛出的都是字符串。上面提到了,Object.assign 会将字符串转成 Object 类型,得到的结果不是很直观。

来个例子看看运行结果:

async function asyncTask(userId, cb) { let err, user, savedTask, notification; [err, user] = await to(UserModel.findById(userId), { errorExt: ' ext error' }); if (err) return cb(err); cb(null, savedTask); } asyncTask(null, (err, newTask) => { console.log('fail'); console.log(err); console.log(newTask); }); 复制代码

运行结果

这个结果并不直观

想要更直观的内容,只能将结果进行一次特殊处理,比如对象循环,只展示 value 值

if (err) { let errList = Object.values(err); let errStr = errList.join(''); return cb(errStr); } 复制代码

运行结果

这次打印的内容直观多了。

关于疑问的部分,仅个人想法,欢迎留言讨论

示例演示

还是上面的例子,这次使用 await-to-js 捕获异常。只需要一行代码,便可轻松捕获异常。

import to from '../../dist'; async function asyncTask(userId, cb) { let err, user, savedTask, notification; [err, user] = await to(UserModel.findById(userId)); // 直接捕获异常 if (err) return cb(err); } asyncTask(null, (err, newTask) => { console.log('fail'); console.log(err); console.log(newTask); }); 复制代码

运行结果

How:使用场景小结

不仅可以直接捕获异常,还可以根据数据的值进行特殊的逻辑处理,帮助完成一些复杂逻辑。

async function asyncTask(userId, cb) { let err, user, savedTask, notification; [err, user] = await to(UserModel.findById(userId)); if (!(user && user.id)) return cb('No user found'); cb(null, savedTask); } 复制代码

运行结果

在上面的代码中,根据得到的 user 的值,进行判断,在实际开发中的实用性更强一些。

总结

await-to-js 源码读完,个人感觉实际用起来,代码会写的比较优雅。而且它的源码内容不多,简单易读。

简单总结一下本文收获:

1、使用 await-to-js,可以帮助改善异步捕获异常的冗余写法。

2、源码的代码量不多,可以作为工具类放到项目中使用。

3、在日常开发中,可以留意一下类似的功能改造,减少重复写法。

以上就是本次分享的内容。如果觉得有帮助,欢迎留言讨论、点赞 、收藏,持续产出技术分享。

我是 叶一一,非职业「传道授业解惑」的技术博主。「趣学前端」、「CSS畅想」系列作者。

华夏美食、国漫、古风重度爱好者,刑侦、无限流小说初级玩家。

欢迎技术或非技术问题的讨论。

本文正在参加「金石计划」



【本文地址】


今日新闻


推荐新闻


CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3